home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / src / cmds / weeklydump / weeklydump.man < prev    next >
Encoding:
Text File  |  1991-09-28  |  3.2 KB  |  104 lines
  1. '\" Copyright 1990 Regents of the University of California
  2. '\" Permission to use, copy, modify, and distribute this
  3. '\" documentation for any purpose and without fee is hereby
  4. '\" granted, provided that this notice appears in all copies.
  5. '\" The University of California makes no representations about
  6. '\" the suitability of this material for any purpose.  It is
  7. '\" provided "as is" without express or implied warranty.
  8. '\" 
  9. '\" $Header: /sprite/src/admin/weeklydump/RCS/weeklydump.man,v 1.5 91/09/28 15:57:10 kupfer Exp $ SPRITE (Berkeley)
  10. '/" 
  11. .so \*(]ltmac.sprite
  12. .HS WEEKLYDUMP cmds
  13. .BS
  14. '\" Note:  do not modify the .SH NAME line immediately below!
  15. .SH NAME
  16. weeklydump \- Script to do weekly fully dumps
  17. .SH SYNOPSIS
  18. \fBweeklydump\fR [\fB\-i\fR] [\fIstartFs\fR]
  19. .SH OPTIONS
  20. .IP "\fIstartFs\fR" 15
  21. Start dumping with the named filesystem.
  22. .IP "\-i" 15
  23. Initialize the tape drives first with ``dump -s''.
  24. .BE
  25.  
  26. .SH DESCRIPTION
  27. .PP
  28. This script does full (level 0) dumps of all the filesystems that are
  29. normally backed up.  It is normally invoked manually over the weekend.
  30. .PP
  31. The script has hard-coded a list of tape devices.  It
  32. dumps filesystems onto the first tape until it gets an error.  It then
  33. continues with the second tape until the next error, etc.  If it runs
  34. out of tapes before all the filesystems have been dumped, it sends
  35. mail to the user 
  36. .B dumper
  37. with the name of the first filesystem in the list that has yet to be
  38. dumped.
  39. .PP
  40. The list of filesystems to dump is contained in
  41. .BR /sprite/admin/dump/dumplist .
  42. If
  43. .B weeklydump
  44. is invoked with the name of a filesystem, it starts with that
  45. filesystem, skipping over the filesystems that appear before it in the
  46. list.  If
  47. .B weeklydump
  48. is not given the name of a filesystem, it looks for the starting
  49. filesystem in
  50. .BR /sprite/admin/dump/doingweekly .
  51. If that file is empty, 
  52. .B weeklydump
  53. simply starts at the top of the list.
  54. .PP
  55. .B Weeklydump
  56. puts the name of the current user in
  57. .BR /sprite/admin/dump/dumpalias .
  58. Mail sent to the ``dumper'' alias is sent to the user named in this
  59. file.  
  60. .B Weeklydump
  61. also creates the file
  62. .BR /sprite/admin/dump/doingweekly ,
  63. which disables the daily dumps.  This
  64. file is removed when the weekly dumps complete.
  65. .PP
  66. If 
  67. .B weeklydump
  68. detects an error, it sends mail to
  69. .B dumper
  70. and exits.  It also creates a status file, so that if the machine
  71. running the weekly dumps
  72. crashes while the dumps are running, mail will be sent to
  73. .B dumper
  74. when the machine reboots, telling about the crash.
  75. .PP
  76. If
  77. .B weeklydump
  78. is invoked with the 
  79. .B \-i 
  80. flag, it will initialize the tapes in both tape
  81. drives before starting.
  82.  
  83. .SH FILES
  84. All the following files are in /sprite/admin/dump:
  85. .IP doingweekly 15
  86. lock file to prevent daily dump from running.  Names the filesystem
  87. currently being dumped.
  88. .IP doingweekly.active 15
  89. status file used to detect crashes.  Contains the name of the host
  90. running the dumps.
  91. .IP dumpalias 15
  92. User name of the current dumper, for error and status messages.
  93. .IP dumpdates 15
  94. list of filesystems dumped, at what time, what tape, etc.
  95. .IP dumplist 15
  96. list of file systems to dump.
  97. .IP dumplog 15
  98. very large status log from the dump programs
  99. .IP tapelist 15
  100. list of tape devices uses for the dump
  101.  
  102. .SH KEYWORDS
  103. dump, tape, backup
  104.